Xtreme Administration Server Guide

Xtreme Administration Server Guide

This basic instruction guide is most useful for new users of the Xtreme Administration 2.1 System.

I will explain in this guide how to:

- Server.cfg mandatory lines.

- Creating your first level 10 user.

- Changing command levels.

- Useful rcon commands to use with the system in scenarios.

- Setting forbidden names / clan tags on your server.

- How to view other resources with further information.

=========================================================

1.0 Setting up SERVER.CFG for use with Xtreme Admin 2.1

=========================================================

Basically, you will need to have some things kept in mind

when configuring your server; the filterscript has to be

in there, the filterscript can not be a game mode, and

some other lines to ensure that your server is displayed

to the master server list.

This is basically how your server.cfg should look:

echo Executing Server Config...

lanmode 0

rcon_password yourrconpassword

maxplayers 200

port 7777

hostname SA:MP 0.2.1 Server

gamemode0 rivershell 1

gamemode1 barron 1

filterscripts XtremeAdmin2 filterscript2 etc (note that you can just have XtremeAdmin2)

announce 1

weburl www.sa-mp.com

password jongay

The three bolded paramaters are the mandatory ones, at least if

you want your server to function properly and display to the

master server list.

If you have more than the Xtreme Admin filterscript, make sure that

XtremeAdmin2 is first in the list. Otherwise, you'll just have

XtremeAdmin2 there.

Make sure lanmode is 0 and announce is 1.

========================================================

2.0 Creating your First Level 10 Administrator Account

========================================================

The process is fairly simple to create a level 10 user

when you first load the filterscript onto your server.

First, start up your server and go ingame.

Secondly, register your account to the server.

Third, go out of game, and browse to your server's

scriptfiles/xadmin/Users directory and open up your

newly registered account's file.

This is the hardest part. Search line by line until you

find "Level=0". If you don't find it, DON'T PANIC! If

you found "Level=0", replace it with "Level=10"; if you

did not find it, simply add "Level=10" to the end of your

file.

Finally, save / upload the file, and go to your remote admin

console (RCON). Log into the rcon and type this command line

into the window: reloadfs XtremeAdmin2

Success! Now if you go back ingame, whether you alt-tabbed or

quit, you should now be level 10. If you still are not level 10,

restart your game once further.

==================================================

3.0 Editing Each Command's Levels the "Easy Way"

==================================================

The Xtreme Administration System makes it very easy for you to

edit command levels, along with the option to set the maximum command

level (default is 10); thus you can have 2, 100, or as many as you need

for your server. Back to the topic, setting command levels.

To set a command level, you will first have to navigate to the .pwn source

for XtremeAdmin2. Once there, search for "CreateCommandConfig". It should

be near the top of the script. You will notice the pattern used immediately;

command name, level, command name, level. Do not edit the command's name, rather

the level to the right of that command.

Say for example you want to change "vr's" level from 0 (user) to 5; you'd go to

the CreateCommandConfig / CreateCommandConfigEx, and change "vr",0 to "vr",5.

Finally, save the script, compile it, upload, and type reloadfs XtremeAdmin2 in the

server rcon window.

================================================================

4.0 Common Scenarios to Reload Xtreme Administration - Crashes

================================================================

Is your server crashing every time you do /giveme, /givecar,

or /weather? Perhaps your server crashes when you connect?

Well, there are two methods to solve these problems.

The common problem is when you restart your gamemode (gmx or

gamemode in rcon), and then try to use menu commands, your server

will crash. This is a SA:MP bug, not XAdmin. To fix this,

simply type reloadfs XtremeAdmin2 in the rcon console every time

you restart the game mode.

Another common problem is that when you connect to the server,

the server will crash. Usually, this will happen when you are

running it on a linux server. Make sure your scriptfiles directory

is CHMODDED to 777. Otherwise, your server will definately crash.

If you have no idea how to change that, contact your FTP Application's

website or manual.

========================================================

5.0 Setting Forbidden Names / Clan Tags on your Server

========================================================

So, you have hacking clans on your server or want to prevent people with

vulgar phrases on your server from joining? Would you like to be able to

kick or ban them with ease? Well, now you can! With this new Xtreme Admin,

you can easily accomplish this. To change / add new forbidden names to your

server, you just have to open up the XtremeAdmin2.pwn source, and search for

"CreateForbiddenNames". You'll once again notice the pattern immediately:

"name1","name2","name3". You can add, change, or keep it entirely blank!

So you have done that, but want to change the option? Well, here's the functions:

Open up your Configuration.ini, and look for "ForbidData". Defaulty, the value is 1,

or to kick. Here's the options: 0 = ignore all, 1 = kick, 2 = ban

Once you have changed that, you can reload the filterscript, or

simply do /uconfig whilst ingame; both work the same.

=========================

6.0 Further Information

=========================

Basically in this guide, I have covered all features that will not be on the first